Gerenciador de Despesas e Receitas

📋 ÍNDICE GERAL

Introdução e Primeiros Passos
Dashboard - Painel Principal
Gestão de Transações
Gerenciamento de Categorias
Gerenciamento de Colaboradores
Relatórios Avançados
Exportação e Importação
Uso em Dispositivos Móveis
Funcionalidades Avançadas
Dicas Avançadas e Melhores Práticas
Solução de Problemas

1. 🚀 INTRODUÇÃO E PRIMEIROS PASSOS

1.1 O que é o Sistema?

O Gerenciador de Despesas e Receitas é uma aplicação web completa desenvolvida para controle financeiro pessoal, familiar ou empresarial.

✨ Características Técnicas:

✅ Funciona 100% no navegador - não requer instalação
✅ Armazena dados localmente no seu computador
✅ Interface em português brasileiro
✅ Totalmente responsivo (computador, tablet e celular)
✅ Tema escuro para melhor visualização
✅ Funciona offline após carregado

1.2 Acessando o Sistema

Primeiro Acesso:

Abra o arquivo HTML no seu navegador preferido
O sistema carrega automaticamente
Todos os dados ficam salvos no seu navegador

⚠️ Importante: Se você limpar os dados do navegador, perderá todas as informações. Faça backup regularmente!

1.3 Estrutura do Menu

📊 DASHBOARD - Visão geral das finanças
💳 ADICIONAR TRANSAÇÃO - Registrar entradas e saídas
🏷️ GERENCIAR CATEGORIAS - Organizar por tipos
👥 GERENCIAR COLABORADORES - Responsáveis pelas transações
📈 RELATÓRIOS - Análises detalhadas
📖 MANUAL DO USUÁRIO - Este guia completo

2. 📊 DASHBOARD - PAINEL PRINCIPAL

2.1 Visão Geral do Dashboard

Ao acessar o sistema, você verá o Dashboard com:

🟢 RECEITAS (MÊS)

Total de dinheiro que entrou

🔴 DESPESAS (MÊS)

Total de dinheiro que saiu

🔵 SALDO (MÊS)

Diferença entre receitas e despesas

2.2 Navegação entre Meses

Como mudar de mês:

No topo do Dashboard, clique nos botões com nomes de meses
Exemplo: "ago 2025", "set 2025", "out 2025"
O mês azul é o mês atualmente selecionado

💡 Dica: O sistema mostra automaticamente os últimos 6 meses que possuem transações. Se não houver transações, mostra o mês atual.

2.3 Filtros Interativos no Dashboard

Nova Funcionalidade: Filtre os dados por ano ou categoria para análises mais precisas.

Filtro de Ano: Selecione um ano específico ou "Todos os Anos"
Filtro de Categoria: Selecione uma categoria ou "Todas as Categorias"
Limpar Filtros: Clique no botão para resetar e ver todos os dados

💡 Dica: Os filtros afetam os cards de resumo, gráficos e transações recentes em tempo real.

2.4 Transações Recentes

Nova Funcionalidade: Veja um preview rápido das últimas 5 transações.

Ordenadas por data (mais recente primeiro)
Coloridas: Verde para receitas, Vermelho para despesas
Aplicam os filtros ativos do dashboard

💡 Dica: Use isso para uma visão rápida sem ir para a seção de transações.

2.5 Interpretando os Gráficos

📈 Gráfico de Pizza (Despesas por Categoria):

Cada "fatia" representa uma categoria de despesa
Cores diferentes para cada categoria
Tamanho da fatia = porcentagem do total gasto
Passe o mouse sobre as fatias para ver valores exatos

🍕 Exemplo Prático:
🟣 Alimentação: 40% (R$ 400,00)
🔵 Transporte: 30% (R$ 300,00)
🟢 Moradia: 20% (R$ 200,00)
🟡 Lazer: 10% (R$ 100,00)

📊 Gráfico de Barras (Receitas x Despesas por Mês):

Barras azuis: Receitas do mês
Barras vermelhas: Despesas do mês
Permite comparar a evolução ao longo do tempo
Ideal para identificar tendências

3. 💰 GESTÃO DE TRANSAÇÕES

3.1 O que é uma Transação?

Uma transação representa qualquer movimento financeiro:

Receita: Dinheiro que ENTRA (salário, vendas, etc.)
Despesa: Dinheiro que SAI (contas, compras, etc.)

3.2 Formulário de Transação - CAMPO A CAMPO

📝 Descrição
O que é: Nome que identifica a transação
Exemplos bons: "Salário Agosto", "Mercado Semanal", "Conserto do Carro"
Exemplos ruins: "Dinheiro" (muito genérico), "Compra" (não especifica o que)

💰 Valor Total (R$)
O que é: Valor total da transação em Reais
Formato: Use ponto para centavos
Exemplos:
• R$ 150,00 → Digite: 150.00
• R$ 2.499,99 → Digite: 2499.99
• R$ 1.000,00 → Digite: 1000.00

🔢 Parcelas
O que é: Número de vezes que o valor será dividido
Padrão: 1 (pagamento à vista)
Como funciona: Valor total ÷ número de parcelas = valor de cada parcela

📦 Exemplo de Parcelamento:
Descrição: "TV Nova"
Valor Total: R$ 1200,00
Parcelas: 3
Resultado: 3 transações de R$ 400,00 cada

🏷️ Categoria
O que é: Classificação da transação
Pré-requisito: A categoria deve existir
Tipos: Receita (entra) ou Despesa (sai)

👥 Colaborador
O que é: Pessoa responsável pela transação
Pré-requisito: O colaborador deve existir
Uso prático: Controle familiar ou por departamentos

📅 Data da Primeira Parcela
O que é: Data quando a primeira parcela ocorre
Formato: DD/MM/AAAA (o sistema formata automaticamente)

🟡 Status
O que é: Situação atual da transação
Opções:
• Pendente: Ainda não foi efetivada
• Pago: Já foi concluída

🔄 Repetir por (meses)
O que é: Número de meses que a transação se repetirá
Uso ideal para: Aluguéis, assinaturas, salários, mensalidades

3.3 Exemplos Práticos de Transações

💼 Exemplo 1: Salário Mensal
Descrição: "Salário Empresa X"
Valor: 3500.00
Parcelas: 1
Categoria: Salário (Receita)
Colaborador: João
Data: 05/08/2025
Status: Pago
Repetir: 12

🛒 Exemplo 2: Compra do Mês
Descrição: "Mercado Familiar"
Valor: 850.50
Parcelas: 1
Categoria: Alimentação (Despesa)
Colaborador: Maria
Data: 10/08/2025
Status: Pago
Repetir: 1

📱 Exemplo 3: Compra Parcelada
Descrição: "Celular Novo"
Valor: 1800.00
Parcelas: 6
Categoria: Eletrônicos (Despesa)
Colaborador: João
Data: 15/08/2025
Status: Pendente
Repetir: 1

3.4 Lista de Transações

Visualização: Cada transação aparece como um card com todas as informações

✏️ EDITAR TRANSAÇÃO:

Clique no botão de editar (ícone de lápis)
O formulário é preenchido automaticamente
Altere os campos necessários
Clique em "Atualizar Transação"

🗑️ EXCLUIR TRANSAÇÃO:

Clique no botão de excluir (ícone de lixeira)
Confirme a exclusão
Atenção: Esta ação não pode ser desfeita!

✅ MARCAR COMO PAGO:

Clique no botão "Marcar como Pago" (ícone de check)
O status da transação será alterado automaticamente
Ideal para atualizar rapidamente transações pendentes

3.5 Botões de Ação em Lote

📤 Exportar Backup
O que faz: Gera arquivo Excel com TODAS as transações
Uso: Backup mensal ou análise externa
Arquivo gerado: relatorio_transacoes.xlsx

📥 Importar Backup
O que faz: Carrega transações de arquivo Excel
Pré-requisitos:
• Arquivo deve ter formato específico
• Categorias e colaboradores devem existir previamente

✅ Marcar Todas como Pagas
Nova Funcionalidade: Altera o status de todas as transações pendentes para "Pago"
Uso: Ao final do mês, para fechar o ciclo
Atenção: Esta ação não pode ser desfeita facilmente

🗑️ Apagar Todas as Transações
Nova Funcionalidade: Abre um modal para excluir por período (data ou mês específico)
Modos:
• Por intervalo de datas (inicial a final)
• Por mês específico (ano + mês)
Atenção: Sempre faça backup antes! Não pode ser desfeita.

3.6 Backup Automático

Nova Funcionalidade: Após adicionar ou atualizar uma transação, o sistema gera automaticamente um backup Excel e o baixa na pasta Downloads.

Arquivo: relatorio_transacoes.xlsx
Sobrescreve o anterior se o nome for o mesmo
Ideal para backups frequentes sem esforço manual

💡 Dica: Verifique a pasta Downloads após salvar transações.

4. 🏷️ GERENCIAMENTO DE CATEGORIAS

4.1 O que são Categorias?

Categorias são etiquetas que organizam suas transações. Sem categorias, você não pode registrar transações!

4.2 Criando Categorias

📋 Formulário de Categoria
Nome da Categoria: Seja claro e específico
Tipo: Receita (entra) ou Despesa (sai)

💡 Lista de Categorias Recomendadas - DESPESAS:

🏠 Moradia
• Aluguel
• Condomínio
• IPTU
• Manutenção

🍎 Alimentação
• Supermercado
• Restaurante
• Lanches
• Feira

🚗 Transporte
• Combustível
• Ônibus/Uber
• Manutenção Carro
• IPVA

💡 Utilidades
• Energia Elétrica
• Água
• Internet
• Gás

💡 Lista de Categorias Recomendadas - RECEITAS:

💰 Salário
• Salário Principal
• Salário Extra
• 13º Salário

💼 Rendimentos
• Investimentos
• Dividendos
• Juros

🛒 Vendas
• Venda Produtos
• Serviços
• Freelance

🎁 Extraordinárias
• Presentes
• Restituição
• Herança

4.3 Gerenciando Categorias Existentes

Visualização: Lista todas as categorias com nome e tipo

✏️ Editando Categoria:

Clique no ícone de lápis ao lado da categoria
O formulário é preenchido automaticamente
Altere o nome ou tipo
Clique em "Atualizar Categoria"
Atenção: Alterar o tipo pode afetar relatórios existentes!

🗑️ Excluindo Categoria:

Só é possível se NENHUMA transação usar a categoria
Clique no ícone de lixeira
Confirme a exclusão

💡 Dica Importante: Crie categorias antes de começar a usar o sistema!

5. 👥 GERENCIAMENTO DE COLABORADORES

5.1 O que são Colaboradores?

Colaboradores são pessoas ou departamentos responsáveis pelas transações. Útil para:

Controle familiar (cada membro da família)
Controle empresarial (setores da empresa)
Controle pessoal (diferentes fontes de renda)

5.2 Criando Colaboradores

👤 Formulário Simples
Nome do Colaborador: Use nomes claros e consistentes
Exemplos: "João Silva", "Departamento Vendas", "Família"

🏠 Exemplos de Estrutura para Família:
👨‍👩‍👧‍👦 Família Silva
  ├── João (pai)
  ├── Maria (mãe)
  ├── Pedro (filho)
  └── Ana (filha)

🏢 Exemplos de Estrutura para Empresa:
🏢 Empresa XYZ
  ├── Vendas
  ├── Financeiro
  ├── Compras
  ├── RH
  └── Diretoria

5.3 Gerenciando Colaboradores Existentes

✏️ Editando Colaborador:

Clique no ícone de lápis ao lado do colaborador
O formulário é preenchido automaticamente
Altere o nome
Clique em "Atualizar Colaborador"

🗑️ Excluindo Colaborador:

Só é possível se NENHUMA transação usar o colaborador
Clique no ícone de lixeira
Confirme a exclusão

6. 📈 RELATÓRIOS AVANÇADOS

6.1 O que são Relatórios?

Relatórios são filtros avançados que permitem analisar seus dados de forma específica.

6.2 Filtros Disponíveis

📅 Filtro por Data
Data Inicial: Data de início do período
Data Final: Data de término do período
Uso: Analisar períodos específicos

🏷️ Filtro por Categoria
Opções: Todas as categorias existentes
Uso: Ver apenas transações de uma categoria

👥 Filtro por Colaborador
Opções: Todos os colaboradores existentes
Uso: Analisar transações de uma pessoa/departamento

🔄 Filtro por Tipo
Opções:
• Todas (receitas e despesas)
• Apenas Receitas
• Apenas Despesas

🔀 Ordenação
Opções:
• Data (mais antiga primeiro)
• Data (mais recente primeiro)
• Valor (menor primeiro)
• Valor (maior primeiro)

6.3 Como Gerar um Relatório

Clique em "Relatórios" no menu
Preencha os filtros desejados
Clique em "GERAR RELATÓRIO"
Veja o Total Filtrado e a lista de transações

6.4 Exemplos Práticos de Relatórios

💰 Relatório de Receitas do Mês
Data Inicial: 01/08/2025
Data Final: 31/08/2025
Categoria: Todas
Colaborador: Todos
Tipo: Apenas Receitas
Ordenação: Data (mais recente)

🏠 Relatório de Despesas com Moradia
Data Inicial: 01/01/2025
Data Final: 31/12/2025
Categoria: Moradia
Colaborador: Todos
Tipo: Apenas Despesas
Ordenação: Valor (maior primeiro)

6.5 Exportação de Relatórios

📊 Exportar para Excel
O que gera: Planilha Excel com os dados
Conteúdo: Cabeçalhos, transações filtradas e total
Arquivo: relatorio_transacoes.xlsx

7. 💾 EXPORTAÇÃO E IMPORTAÇÃO

7.1 Sistema de Backup

📤 Exportação Completa
Onde: Na seção "Adicionar Transação"
O que exporta: TODAS as transações do sistema
Formato: Excel (.xlsx)
Uso: Backup mensal ou migração para outro sistema

📥 Importação em Lote - PRÉ-REQUISITOS IMPORTANTES:

Categorias devem existir no sistema
Colaboradores devem existir no sistema
Formato do arquivo deve ser correto

7.2 Formato do Arquivo Excel Exigido

7.3 Validações na Importação

✅ Descrição não pode estar vazia
✅ Valor deve ser número positivo
✅ Categoria deve existir no sistema
✅ Colaborador deve existir no sistema
✅ Data deve ser válida
✅ Status deve ser "Pendente" ou "Pago"

7.4 Processo de Importação

Prepare o arquivo Excel no formato correto
Clique em "Importar Backup"
Selecione o arquivo
Aguarde a validação
Confirme a importação

💡 Em Caso de Erros:

O sistema mostra quais linhas têm problemas
Apenas as transações válidas são importadas
Transações com erro são ignoradas

8. 📱 USO EM DISPOSITIVOS MÓVEIS

8.1 Interface Mobile

☰ Menu Mobile
• Botão ☰ no canto superior esquerdo
• Menu deslizante que cobre a tela
• Toque fora do menu (overlay escuro) para fechar

📋 Formulários Mobile
• Campos maiores para toque fácil
• Teclado otimizado para cada tipo de campo
• Scroll suave

📊 Gráficos Responsivos
• Redimensionam automaticamente
• Toque para ver detalhes
• Funcionam igual à versão desktop

8.2 Dicas para Uso Mobile

✅ Faça:

Use em celular e tablet
Toque nos botões com calma
Use rolagem vertical
Feche o menu após selecionar uma opção

❌ Evite:

Fechar a aba sem salvar
Usar em conexão instável (embora funcione offline)
Limpar dados do navegador sem backup

9. ⚙️ FUNCIONALIDADES AVANÇADAS

9.1 Menu Lateral Colapsável (Desktop)

Nova Funcionalidade: No desktop, clique no ícone de seta no topo do menu para recolher o sidebar e ganhar mais espaço na tela.

Largura normal: 16rem (com textos)
Colapsado: 4rem (apenas ícones)
Transição suave e automática no conteúdo principal

💡 Dica: Útil em telas menores ou para foco no conteúdo.

9.2 Impressão do Manual

Nova Funcionalidade: No final do manual, use o botão "Imprimir Manual" para gerar uma versão PDF/Impressa.

Abre em nova aba otimizada para impressão
Estilos ajustados para legibilidade em papel
Salve como PDF no navegador

💡 Dica: Ideal para consulta offline sem internet.

9.3 Botões Fixos no Manual

Nova Funcionalidade: Botões "Imprimir" e "Voltar ao Topo" ficam fixos no final do manual para navegação fácil.

Sticky no scroll
Responsivo: Pilha vertical no mobile

10. 💡 DICAS AVANÇADAS E MELHORES PRÁTICAS

10.1 Fluxo de Trabalho Recomendado

🔄 Rotina Diária/Semanal

Todo dia: Registrar transações do dia
Toda semana: Revisar o Dashboard
Todo mês: Exportar backup e gerar relatórios

📅 Setup Inicial (PRIMEIRA VEZ)

Criar Categorias (todas que vai usar)
Criar Colaboradores (pessoas/departamentos)
Importar Backup antigas (opcional)
Começar a registrar transações atuais

10.2 Estratégias de Categorização

🎯 Método 50-30-20 (Pessoal)
50% - Necessidades
  ├── Moradia
  ├── Alimentação
  ├── Transporte
  └── Saúde

30% - Desejos
  ├── Lazer
  ├── Restaurantes
  ├── Viagens
  └── Hobbies

20% - Poupança/Investimentos
  ├── Reserva Emergencial
  ├── Investimentos
  └── Aposentadoria

🏢 Método Empresarial
💼 Operacionais
  ├── Vendas
  ├── Custos
  ├── Despesas Fixas
  └── Despesas Variáveis

💰 Financeiro
  ├── Receitas
  ├── Despesas
  ├── Investimentos
  └── Empréstimos

👥 Departamentos
  ├── Vendas
  ├── Marketing
  ├── RH
  └── TI

10.3 Controle de Orçamento

📊 Como Usar o Dashboard para Controle

Defina metas mensais para cada categoria
Compare meta vs realizado nos gráficos
Ajuste gastos conforme necessário

🔔 Sinais de Alerta

Saldo negativo constante
Uma categoria consumindo mais de 50% da renda
Despesas crescendo mais que receitas

10.4 Backup e Segurança

💾 Estratégia de Backup
📅 Backup Diário: Mantenha o navegador aberto
📅 Backup Semanal: Exporte transações para Excel
📅 Backup Mensal: Salve arquivo Excel em nuvem/pendrive

🛡️ Dicas de Segurança

Não use em computadores públicos
Exporte backups regularmente
Mantenha seu navegador atualizado

11. 🔧 SOLUÇÃO DE PROBLEMAS

11.1 Problemas Comuns e Soluções

❌ "Não consigo adicionar transação"
Causas possíveis:

Categoria não existe → Crie a categoria primeiro
Colaborador não existe → Crie o colaborador primeiro
Campos obrigatórios vazios → Preencha todos os campos

❌ "Gráficos não aparecem"
Causas possíveis:

Não há transações no período → Adicione transações
Navegador desatualizado → Atualize o navegador
JavaScript bloqueado → Permita JavaScript

❌ "Dados sumiram"
Causas possíveis:

Navegador foi limpo → Restaure do backup
Acessou de outro navegador → Use sempre o mesmo
Arquivo corrompido → Importe do último backup

❌ "Importação com erros"
Verifique:

Formato das colunas no Excel
Categorias existem no sistema
Colaboradores existem no sistema
Datas no formato correto

❌ "Modal de exclusão não valida"
Causas possíveis:

Datas inválidas (inicial > final) → Corrija as datas
Mês/ano não selecionado → Escolha valores válidos

11.2 Perguntas Frequentes (FAQ)

🤔 Posso usar em mais de um computador?
Resposta: Sim, mas os dados não sincronizam automaticamente. Exporte de um e importe no outro.

🤔 Quantas transações suporta?
Resposta: Milhares! O limite é a memória do seu navegador.

🤔 Posso mudar o formato de data?
Resposta: O sistema usa automaticamente o formato brasileiro (DD/MM/AAAA).

🤔 Como faço para reiniciar tudo?
Resposta: Limpe os dados do navegador OU delete todas as transações manualmente.

🤔 Posso usar para negócios?
Resposta: Sim! A estrutura de categorias e colaboradores é perfeita para controle empresarial.

🤔 Por que o backup é automático após salvar?
Resposta: Para garantir que você não perca dados recentes. Desative se preferir (edite o código).

🎯 CHECKLIST DE IMPLEMENTAÇÃO

Para Começar AGORA:

Criar categorias básicas
Criar colaboradores
Registrar primeira transação
Explorar o Dashboard
Fazer primeiro backup

Para Uso Avançado:

Definir estrutura de categorias personalizada
Criar relatórios mensais automáticos
Estabelecer rotina de backup
Treinar outras pessoas no uso
Testar filtros no dashboard
Usar exclusão por período para limpezas